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GW-BASIC Summary 


ABS(X) 

Returns the absolute value of the expression X. 

ASC(XS) 

Returns a numerical value representing the ASCII 
code for the first character of the string X$. 

(See Appendix for ASCII codes.) 

ATN(X) 

Returns the arctangent of X, where X is in 
radians. Result is in the range -pi/2 to pi/2 
radians. 

AUTO [dine number>[,<increment>]] 

Automatically generates line numbers during 
program entry. 

BEEP 

Sounds the speaker (via the ASCII bell character). 

BLOAD <filespec> [,<offset>] 

Loads a specified memory image file into memory 
from any input device. 

BSAVE dilespec>,<offset>,dength> 

Transfers the contents of the specified area of 
memory to any output device. 

CALL <variable name>[(<argument list>)] 

Calls an assembly language subroutine or a 
compiled routine written in another high level 
language. 

(Also CALLS) 

CDBL(X) 

Converts X to a double precision number. 

CHAIN [MERGE ]dilespec>[,[dine number 
ex P> ][,ALL][,DELETE <range>]] 

Calls a program and passes variables to it from the 
current program. 

CHDIR Pathname 

Changes the current operating directory. 

CHR$(I) 

Returns a string whose one character has the 
ASCII value of 1. (See Appendix for ASCII codes). 

CINT(X) 

Converts X to an integer by rounding the 
fractional portion. 



C1RCLE[STEP] (<xcentre>,<ycentre>), 
<radius> [,< colour >[,< start >,< end >[, 
<aspect>]]] 

Draws an ellipse or circle with the specified centre 
and radius. 

CLEAR [,[< expression 1 >][,<expression2>]] 

Sets all numeric variables to zero, all string 
variables to null, closes all open files;also sets the 
end of memory and the amount of stack space. 

CLOSE [[#]<file number>[ / [#]<file number.. .>]] 

Concludes I/O to a file. The CLOSE statement 
complements the OPEN statement. 

CLS 

Erases contents of entire current screen. 

COLOR [<parameter1 >][,<parameter2>...] 

The syntax and purpose of the COLOR statement 
is machine dependent. Usually the form is as 
above. Selects the foreground, background,and 
border colours for the graphics display, and 
affects the colour of text. These colours will be 
used by the PSET, PRESET, and LINE statements. 

COMMON < list of variables> 

Passes variables to a chained program. 

CONT 

Continues the program after a Break has been 
typed or a STOP statement been made. 

COS(X) 

Returns the cosine of X, where X is in radians. 

CSNG(X) 

Converts X to a single precision number. 

CSRLIN 

Obtains the current line position of the cursor in a 
numeric variable. 

CVI,CVS,CVD 

Converts string values to numeric values. 

DATA < list of constants^ 

Stores the numeric and string constants accessed 
by the program's READ statement(s). 

DATE$ = <string expression 

Sets the current date. It complements the DATES 
function, which retrieves the current date. 

DATES 

Prints the date, calculated from the date set with 
the DATES statement. 


DEF FN<name>[(<parameter list > )] = 
efunction definition> 

Defines and names a function you have written. 

DEF<type> <range(s) of letters^ 

Declares variable types as integer, single 
precision, double precision, or string. 

DEF SEG [ = <address>] 

Assigns the current segment address to be 
referenced by subsequent BLOAD, BSAVE, CALL, 
CALLS, or POKE statements or by the USR or 
PEEK functions. 

DEF USR[<digit>] = <integer expression> 

Specifies the starting address of an assembly 
language routine. 

DELETE | [dine number>][-<line number>] 

[dine number >-] \ 

Deletes program lines. 

DlMdist of subscripted variables> 

Specifies the maximum values for array variable 
subscripts and allocates storage accordingly. 

DRAW <string expression> 

Draws an object defined by subcommands. 

EDIT dine number> 

Edits the specified line. 

END 

Terminates a program, closes all files, and returns 
to command level. 

EOF(<file number>) 

Tests for the end-of-file condition. 

ERASEdist of array variables> 

Eliminates arrays from memory. 

ERR ERL 

Contains the error codes and the line number of 
the error. 

ERROR dnteger expression> 

Simulates a BASIC error or defines error codes. 

EXP(X) 

Returns e (base of natural logarithms) to the 
power of X. X must be < = 88.02969. 

FIELD [#]<file number>,dield width> 

AS ^string variables 

Allocates space for variables in a random file 
buffer. 


FILES [<filespec>] 

Prints the names of files on the specified disk. 

FIX(X) 

Returns the truncated integer part of X. 

FOR <variable>=x TO y [STEP z] 


NEXT [<variable>][,<variable>...] 

Allows a series of instructions to be performed in 
a loop a given number of times. 

FRE(O) 

FREr ") 

With a numeric argument, FRE returns the 
number of bytes in memory not being used. 
Arguments to FRE are dummy ones. 

GET [#]<file number>[,<record number>] 

Reads a record from a random disk file into a 
random buffer. 

GET (x1,y1)-(x2,y2),<array name> used with 
PUT (x1,y1),<array name>[,action verb] 

The GET and PUT statements are used together to 
transfer graphic images to and from the screen. 

GOSUB dine number> 


RETURN [dine number>] 

Branches to and returns from a subroutine. 

GOTO dine number> 

Branches unconditionally to a specified line 
number. 

HEX$(X) 

Returns a string representing the value of the 
decimal argument. 

IF <expression>[,]THEN { <statement(s)d 
dine number>} 

[,[ELSE | <statement(s)>:dine number>}]] 

IF <expression>[,]GOTO <linenumber> 
[,[ELSE | <statement(s)>!<line number> }•]] 
Makes a decision on program flow based on the 
result returned by an expression. 

INKEY$ 

Returns either a one-character string containing a 
character read from the standard input device or 
a null string if there isn't a character pending.The 
keyboard is usually the standard input device. 



INP(I) 

Returns the byte read from port I. I must be in the 
range zero to 65535. 

INPUT[;] [< "prompt string"> ;]<list of 
variables> 

Allows input from the keyboard during a program. 

INPUT#<file number>,<variable list > 

Reads data items from a sequential device or file 
and assigns them to program variables. 

INPUT$(X[,[#]Y]) 

Returns a string of X characters, reads from file 
number Y. If the file number is not specified, the 
characters are read from the standard input 
device. 

INSTR([I,]X$,Y$) 

Searches for the first occurrence of string Y$ in 
X$, and returns the matched position. Optional 
offset I sets the position for starting the search. 

INT(X) 

Returns the largest integer < =X. 

KEY n, X$ 

KEY LIST 
KEY ON 
KEY OFF 

Assigns softkey values to function keys and 
displays the values. 

KEY(n)ON 

KEY(n)OFF 

KEY(n)STOP 

Enables or disables event trapping of softkey or 
cursor direction key activity for the specified 
trappable key. 

KILL [<filespec>] 

Deletes a file or a pathname from disk. 

LEFT$(<string>,l) 

Returns a string comprising the leftmost I 
characters of X$. 

LEN(<string>) 

Returns the number of characters in <string>. 
Nonprinting characters and blanks are counted. 

[LET ]<variable> = <expression> 

Assigns the value of an expression to a variable. 

LINE [[;]STEP](x1,y1)]-[STEP](x2,y2) 

[,[< colour >][,b[f]]][,style] 

Draws a line or box on the screen. 


LINE INPUT[;] [d'prompt string''^*;] 

< string variable^ 

Inputs an entire line of upto 254 characters to a 
string variable, without the use of delimiters. 

LINE INPUT#<file number>,<string 
variable^ 

Reads an entire line (up to 254 characters), 
without delimiters, from a sequential disk data file 
to a string variable. 

LIST [dine number>] [-[dine number^]] 
[,<device>] 

Lists all or part of the program currently in 
memory. 

LLIST [dine number>[-[dine number>] 

Lists all or part of the program currently in 
memory on the line printer. 

LOAD <filespec>[,R] 

Loads a file from an input device into memory. 

LOC(<file number>) 

With random disk files, LOC returns the actual 
record number within the file. 

LOCATE [row][,[col][,[cursor][,[start][,stop]]]] 

Moves the cursor to the specified position. 
Optional parameters turn the blinking cursor on 
and off and define the vertical start and stop lines. 

LOCK [#]n[,[(<record number>)][To (<record 
numbers>)]] 

Controls access by other processes to all or part of 
another file. 

LOF(<file number>) 

Returns the length of the named file in bytes, 
when a file is opened for APPEND or OUTPUT. 

LOG(X) 

Returns the natural logarithm of X. X must be 
greater than zero. 

LPOS(X) 

Returns the current position of the print head 
within the printer buffer. 

LPRINT [< list of expressions>] 

LPRINT USING <string exp>;dist of 
expressions> 

Prints data on the printer. 



LSET <string variable> = <string expression> 
RSET <string variable = < string expression> 

Moves data from memory to a random file buffer 
in preparation for a PUT statement. Also left-or 
right-justifies the value of a string into a string 
variable. 

MERGE <filespec> 

Merges a specified file into the program currently 
in memory. 

MID$(<string 1 >,n[,m]) = <string 2> 

Replaces a portion of one string with another 
string. 

MI D$ (< string >,n[,m]) 

Returns a string of length m characters from X$, 
beginning with the nth character. 

MKDIR <pathname> 

Creates a new directory. 

MKI$(<integer expression^) 

MKS$(<single precision expression^ 
MKD$(<double precision expression>) 
Converts numeric values to string values. 

NAME <old filename> AS < new filename> 

Changes the name of an existing disk file. 

NEW 

Deletes the program currently in memory and 
clears all variables. 

OCTS(X) 

Returns a string representing the octal value of 
the decimal argument. X is rounded to an integer 
before OCTS(X) is evaluated. 

ON ERROR GOTO <line number> 

Enables error handling and specifies the first line 
of the error handling routine. 

ON <expression> GOTO dist of line numbers> 
ON <expression> GOSUB < list of line 
numbers^ 

Branches to one of several specified line numbers, 
depending on the value of an expression. 

ON KEY(n) GOSUB dine number> 

Specifies the first line number of a subroutine to 
be performed when a particular key is used. 

ON PLAY (n) GOSUB LINE-NUMBER 

Branches to a specified subroutine when the 
music queue contains fewer than (n) notes. This 
allows continuous music during a program. 


ON STRIG(n) GOSUB dine number> 

Specifies the first line number of a subroutine to 
be performed when the joystick trigger is pressed. 

ON TIMER (n) GOSUB dine-number> 

Provides an event trap during real time. 

OPEN <mode1 >,[#]<file number>, <filespec> 
[,<record length>] 

OPEN <filespec> (FOR <mode2>) AS [#]<file 
number> [LEN = <record length>] 

Allows I/O to a file or a device. 

OPTION BASE(n) 

Declares the minimum value for array subscripts. 

OUTU 

Sends a byte to a machine output port. 

PAINT (<x>,<y>)[,<paint attribute> 
[,<border colour>] ^background attribute]] 
Fills a graphics area with the colour or pattern 
specified. 

PALETTE [<colour number>,<display 

colour>] 

or 

PALETTE USING <array> (<array index>) 

Changes one or more of the colours in the palette. 

PEEK(I) 

Returns the byte read from the indicated memory 
location (I). 

PLAY <string> 

Plays music as specified by <string>. 

PLAY (n) 

Returns the current number of notes in the 
background music queue. 

PLAY ON 
PLAYOFF 
PLAY STOP 

PLAY ON enables play event trapping. 

PLAY OFF disables play event trapping. 

PLAY STOP suspends play event trapping. 

PMAP <expression>, <function> 

Maps world coordinate expressions to physical 
locations and vice versa. 


POINT (<xcoordinate>,<ycoordinate> of the 
pixel to be referenced, 
or 

POINT (<function>) 

Reads the colour number of a pixel from the 
screen, also retrieves the current graphics cursor 
coordinates. 

POKE l,J 

Writes a byte into a memory location. 

POS(I) 

Returns the current horizontal (column) position 
of the cursor. 

PRESET [STEP](<xcoordinate>, 
<ycoordinate>) [,<colour>] 

Draws a specified point on the screen. 

PRINT ['<list of expressions>] 

Outputs data on the screen. 

PRINT USING <string exp>;<list of 
expressions> 

Prints strings or numbers using a specified format. 

PRINT#<file number>,[USING <string 
exp>;] 

<list of expressions> 

Writes data to a sequential file. 

PSET [STEP](<xcoordinate>,<ycoordinate>) 
[,<colour>] 

Draws a specified point on the screen. 

PUT [#]<file number>[,<record number>] 

Writes a record from a random buffer to a 
random access file. 

PUT (x1,y1),<array name>[,action verb] 
used with 

GET (x1,y1)-(x2,y2),<array name> 

Transfers graphic images to and from the screen. 

RANDOMIZE [ <expression>] 

Reseeds the random number generator. 

READ <list of variables> 

Reads values from a DATA statement and assigns 
them to variables. 

REM<remark> 

Allows explanatory remarks to be inserted in a 
program. 

REM <remark>RENUM [[<newnumber>] 
[,[<old number>][, <increment>]]] 

Renumbers program lines. 


RESET 

Closes all files. 

RESTORE [ <line number>] 

Allows DATA statements to be reread from a 
specified line. 

RESUME 
RESUME O 
RESUME NEXT 
RESUME <linenumber> 

Continues the program after an error recovery 
procedure. 

RETURN ... see GOSUB...RETURN 
RIGHT$(X$,I) 

Returns the rightmost I characters of string X$. 

RMDIR<pathname> 

Removes an existing directory. 

RND[(X)] 

Returns a random number between zero and 1. 

RUN [ <line number^] 

RUN <filespec> [,R] 

Runs the program currently in memory, or loads a 
file into memory and runs it. 

SAVE <filespec>[^,A:,P|] 

Saves a program file. 

SCREEN [<spec>] 

Sets the specifications for the displayscreen. 
These may vary according to individual machines. 

SCREEN (<row>,< column >[,z]) 

Reads a character or its colour from a specified 
screen location/ 

SGN(X) 

Indicates the value of X, relative to zero. 

SHELL [<command-string>] 

EXITS from the BASIC program to run .COM, 
.EXE or built in DOS functions. 

SIN(X) 

Returns the sine of X, where X is in radians. 

SOUND <freq>,<duration> 

Generates a sound through the speaker. 

SPACE$ (1) 

Returns a string of spaces of length I. 

SPC(n) 

Inserts spaces in a PRINT statement. 


SQR(X) 

Returns the square root of x. 

STICK(n) 

Returns the x and y coordinates of the two 
joysticks. 

STOP 

Ends a program and returns to command level. 

STR$(n) 

Returns a string representation of the value of n. 

STRIG(n) 

Returns the status of a specified joystick trigger. 

STRIGON 

STRIGOFF 

STRIGSTOP 

STRIG ON enables event trapping of joystick 
activity. STRIG OFF disables event trapping of 
joystick activity. STRIG STOP also disables event 
trapping of joystick activity. 

STRING$(I,J) 

STRINQ$(I,X$)SWAP < variable >,< variable > 

Returns a string of length I whose characters have 
ASCII code J or the first character of X$. 

SWAP <variable>,<variable> 

Exchanges the values of two variables. 

SYSTEM 

Closes all open files, returns control to the 
operating system and exits. 

TAB(I) 

Moves the print position to I. 

TAN(X) 

Returns the tangent of X. X should be given in 
radians. 

TIME$ = <string expression> 

Sets the time, complements the TIMES function, 
which retrieves the time. 

TIMES 

Retrieves the current time. 

TIMER ON 
TIMER OFF 
TIMER STOP 

TIMER ON enables event trapping during real time. 
TIMER OFF disables event trapping during real time. 
TIMER STOP suspends real time event trapping. 


TRON 

TROFF 

Traces program statements. 

UNLOCK [#]n[,[(<record number)][to 
(<record number>)]]. 

See Lock Statement. 

USR[<digit>][(<argument>)] 

Calls an assembly language subroutine. 

VAL(<string>) 

Returns the numeric value of string . Also strips 
leading blanks, tabs, and linefeeds from the 
argument string. 

VARPTR(<variable name>) 

VARPTR(#<file number>) 

Returns the address of the first byte of data 
identified with the variable name. 

For sequential files, returns the starting address of 
the disk I/O buffer assigned to |file number}-. 

For random files, returns the address of the 
FIELD buffer assigned to J file number). 

VARPTR$(<variable name>) 

Returns a character form of the memory address 
of the variable in a compatible form for any later 
programs. 

VIEW [ [SCREEN] [(Vx1,Vy 1)-(Vx2,Vy2) 
[,[<colour>][,[<border>]]]] ] 

Defines screen limits for graphics activity. 

VIEW PRINT [<top screen line> TO <bottom 
screen line>] 

Sets the boundaries of the screen text window. 

WAIT <port number>,l[,J] 

Suspends a program while monitoring the status 
of a machine input port. 

WHILE <expression> 


[< loop statements>] 


WEND 

Performs a series of statements in a loop as long 
as a given condition is true. 


WIDTH [LPRINT ]<size> 

WIDTH <file number>,<size> 

WIDTH <device>,<size> 

Sets the printed line width in number of 
characters for the screen or line printer. 

WINDOW [[SCREEN] (Wx1,Wy 1)-(Wx2 / Wy2)] 

Defines the logical dimensions of the current 
viewport. 

WRITE [< list of expressions>] 

Outputs data to the screen. 

WRITE# <file number^, list of expressions> 
Writes data to a sequential file. 
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